home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / bbs / arp206.zip / ARP.DOC next >
Text File  |  1997-07-16  |  14KB  |  397 lines
  1.  
  2.  
  3.                   ------------------------------              16. July 1997
  4.                    Adept Request Prozessor  ARP
  5.                   ------------------------------
  6.                          Version 2.06
  7.  
  8.  
  9. Topics:
  10.  
  11. What is the Adept Request Prozessor ...................... I
  12. Warranty ................................................. II
  13. Copyright information .................................... III
  14. Before installation ...................................... IV
  15. How to install Adept Request Prozessor ................... V
  16. How to run Adept Request Prozessor ....................... VI
  17. Troubleshooting .......................................... VII
  18. Registration ............................................. VIII
  19. How to contact the Author ................................ IX
  20.  
  21.  
  22.  
  23.  
  24. I - What is the Adept Request Prozessor?
  25. ----------------------------------------
  26.  
  27. The ARP is a small utility to answer fts styled file frequests.
  28. ARP reads out all frequests, compares your magics contained in your
  29. ok files and builds a frequest response message.
  30.  
  31. The following is an example of a frequest response message.
  32. The first two files are frequested using magic files and ADEPT, the third is
  33. automaticly send by ARP:    
  34.  
  35. [only comments!]
  36.  
  37.  
  38.              -------------- < EXAMPLE > -------------
  39.  
  40. [header file]
  41.  
  42. ┌────────────────────────────────────────────────────────────────────────────┐
  43. ▄▄▄ ▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ▄▄▄     ▄▄▄▄▄▄▄ ▄▄▄ ▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄
  44. █ █ █ █ █ ▄▄▄▄█ █ ▄▄▄ ██ ▄▄▄ █ █ █     █ ▄▄▄ █ █ ▀██ █ █ ▄▄▄▄█ █▄▄ ▄▄█ █ ▄▄▄▄█
  45. █▄▀█▀▄█ █ █▄▄ █ █ ▄▄▄ ██ ▄▄▄▄█ █ █▄▄▄▄ █ ▄▄▄ █ █ █▄▀ █ █ ▄▄▄█▄   █ █   █▄▄▄▄ █
  46. │▀█▄█▀  █▄▄▄▄▄█ █▄█ █▄██▄█     █▄▄▄▄▄█ █▄█ █▄█ █▄█▀█▄█ █▄▄▄▄▄█   █▄█   █▄▄▄▄▄█
  47. │                         ▄▄▄▄▄▄  ▄▄▄▄▄▄▄ ▄▄▄ ▄▄▄                            │
  48. │  Sysop:  Klaus Ader     █ ▄▄ █▄ █ ▄▄▄ █ █▄▀█▀▄█   0201-898524 ISDN + V34   │
  49. │  Limits: your own bill  █ ▄▄▄ █ █ █▄█ █ ▄█▀▄▀█▄   0201-898598 ISDN         │
  50. │                         █▄▄▄▄▄█ █▄▄▄▄▄█ █▄█▀█▄█        außer ZMH           │
  51. └────────────────────────────────────────────────────────────────────────────┘
  52.  
  53. [frequest response]
  54.  
  55.                     let's talk about your frequest at 
  56.                         my bulletin board system:
  57.  
  58.                          You are connected to line 1                         
  59.                Session type: Password protected mailer session               
  60.  
  61. ══════════════════════════════════════════════════════════════════════════════
  62.  
  63.  Dateiname          Groesse   Datum      Beschreibung
  64.  ────────────       ───────   ────────   ─────────────────────────────────────
  65.  ALL391.ZIP         250010    18/08/96   Komplette Fileliste der
  66.                                          VGA-PLANETS-BOX
  67.                                          V34   0201-898524  ISDN
  68.                                          0201-898598  ISDN
  69.                                          
  70.                   Frequested via magic:  FILES
  71.  
  72.  
  73.  Dateiname          Groesse   Datum      Beschreibung
  74.  ────────────       ───────   ────────   ─────────────────────────────────────
  75. BULLSHIT                                 Could not find this file!!!
  76.                                          If your syntax is correctly,
  77.                                          PLEASE report!
  78.  
  79.  
  80.  Dateiname          Groesse   Datum      Beschreibung
  81.  ────────────       ───────   ────────   ─────────────────────────────────────
  82.  ADPT107F.ZIP       1865121   23/04/96   AdeptXBBS v1.07f  !Freeware!
  83.                                          AdeptXBBS 32-bit OS/2 multi-user,
  84.                                          multi-threaded, multi-line, PM BBS
  85.                                          for OS/2 v2.x, and Warp.
  86.                                          
  87.                                          AdeptXBBS requires HPFS, and will
  88.                                          not install on a FAT based drive.
  89.                                          
  90.                                          AdeptXBBS includes and full BBS, a
  91.                                          Fidonet Capable Mailer, and Fidonet
  92.                                          message base utilities.
  93.                                          
  94.                                          This is BOTH a Upgrade and a
  95.                                          FULL INSTALL.
  96.                                          
  97.                   Frequested via magic:  ADEPT
  98.  
  99.  
  100.  Dateiname          Groesse   Datum      Beschreibung
  101.  ────────────       ───────   ────────   ─────────────────────────────────────
  102.  AD-NET.ZIP         866       16/06/96   ┌────────────────────────────┐
  103.                                          │Nodeantrag fuer das AdeptNet│
  104.                                          │============================│
  105.                                          │                            │
  106.                                          │Bitte ausfuellen und zurueck│
  107.                                          │schicken. Postwendend kommt │
  108.                                          │Deine AdeptNet AKA!         │
  109.                                          │                            │
  110.                                          └──────═══ by BK'96 ══───────┘
  111.                                          
  112.                   Frequested via magic:  Automatic Send
  113.  
  114. ══════════════════════════════════════════════════════════════════════════════
  115.  
  116.                             --=== Breakdown ===--                             
  117.  
  118.                        Your frequest at VGA-PLANETS-BOX                       
  119.                           Total 2115.99kB in 4 Files                          
  120.                             ----- ========= -----                             
  121.  
  122.                              ▄▄▄·    ▄▄▄      ▄▄▄·                            
  123.                             ▐█ ▀█    ▀▄ █·   ▐█ ▄█                            
  124.                             ▄█▀▀█    ▐▀▀▄     ██▀·                            
  125.                             ▐█ ■▐▌   ▐█∙█▌   ▐█■·∙                            
  126.                              ▀  ▀    .▀  ▀   .▀                              
  127.  
  128.                                Version 2.06
  129.                                16. July 1997
  130.                             Registered Version for                            
  131.                               BK - 2:2448/391.0                           
  132.  
  133.                       Home of Adept's Request Prozessor                       
  134.                              VGA - PLANETS - BOX                              
  135.                              2:2448/391.0@FidoNet                             
  136.                                 (C) by BK '97                                 
  137.  
  138. [footer file]
  139.  
  140.  ==========================================================================
  141.                          VGA-PLANETS-BOX MAGICS
  142.  ==========================================================================
  143.  
  144.               Files         Kompl. Fileliste
  145.               ALLINF        Kompl. Fileliste in OS2 INF Version
  146.               Adeptlist     Fileliste Adept tools / progs
  147.               AdeptInf      Adept tools in OS2 INF Version
  148.               NewFiles      Neue Files der letzten 14 Tage
  149.               VPLLIST       VGA-PLANETS-Tools Fileliste
  150.               VPLINF        VGA-PLANETS-Tools Fileliste in OS2 INF Version
  151.               ADEPT         neuste Version von AdeptXBBS
  152.               T4UPLS        neueste Version von "Tasks 4 U Plus" / DOS
  153.               Adeptmail     AdeptMail V0.99wb PM-based mail reader fuer Adept
  154.               Adapt         Adept MSG Base Management Tool - Try It
  155.  
  156.              -------------- < EXAMPLE > -------------
  157.  
  158. II - Warranty
  159. -------------
  160.  
  161. What is that? Never heard before!
  162. There is only a guarantee that this file uses space on your harddrive.
  163.  
  164.  
  165.  
  166. III - Copyright Information
  167. ---------------------------
  168.  
  169. AdeptSoft and AdeptXBBS are registered trademarks of AdeptSoft.
  170. XBBS copyright (c) 1988 - 1994 by M. Kimes.
  171. The XBBS name is a trademark of M. Kimes.
  172. VX-REXX is a trademark of Watcom
  173. ReqRob is (c) by S.Homburg
  174.  
  175.  
  176. IV - Before Installation
  177. ------------------------
  178.  
  179. You must VROBJ.DLL in your libpath! Version 2.14, 1.09.1995
  180. Check your Adept Setup:
  181. Config -> Active line -> mailer settings
  182.  
  183. Mail Proc.CMD:  Cmd.Exe /c Mail.Cmd 1 %s
  184.  
  185. 1  indicates your line
  186. %s is an arg line parameter, indicates your actual inbound path
  187.  
  188. so if you 're running a multiline system, your second line should look like
  189.  
  190.            Cmd.Exe /c Mail.Cmd 2 %s
  191.            Cmd.Exe /c Mail.Cmd 3 %s
  192.            Cmd.Exe /c Mail.Cmd 4 %s  etc.
  193.  
  194. V - How to Install ARP
  195. ----------------------
  196.  
  197. Very simple:
  198.  
  199. 1.Step
  200. Unzip the archive in any directory you want
  201. and run:
  202.  
  203.           ARP200.EXE Setup
  204.  
  205. and follow the instructions on your screen.
  206. You also can manually edit ARP2.INI:
  207.  
  208. 1. line: your Adept path
  209. 2. line: header for your answers
  210. 3. line: footer
  211. 4. line: send this file on every frquest (ex. AdeptNet.ZIP) Leave this line blank if 
  212.          you do not want to send a file automaticly on any freq!
  213. 5. line: Name of Your BBS
  214. 6. line: Path to your ok-files
  215. 7. line: 1=add download counters
  216. 8. line: 1=add free file fino
  217.  
  218.  
  219. Example:
  220. ========
  221.  
  222. C:\ADEPT\    
  223. C:\ADEPT\tools\arp2\HEADER.TXT
  224. C:\ADEPT\tools\arp2\FOOTER.TXT
  225. AD-NET.ZIP
  226. VGA-PLANETS-BOX
  227. C:\ADEPT\MAILER\
  228. 1
  229. 1
  230.  
  231.  
  232. 2.Step
  233. Edit your MAIL.CMD. Normal mail.cmd should look like:
  234.  
  235. ---------------- <cut> ---------------------------
  236. rem  ======================================
  237. rem  ----ARP:
  238. rem  ======================================
  239.  
  240. cd \adept\tools\arp2
  241. arp200.exe %1 %2
  242.  
  243. rem  ======================================
  244. rem  ----File Ticer:
  245. rem  ======================================
  246.  
  247. cd \adept
  248. yaticp.exe
  249.  
  250. rem  ======================================
  251. rem  ----Matrix Mailing
  252. rem  ======================================
  253.  
  254. cd \adept\tools\yabom
  255. yabomp matrix
  256.  
  257. rem  ======================================
  258. rem  ----Mail Tosser:
  259. rem  ======================================
  260.  
  261. cd \adept
  262. Gatekpr.Exe GateKpr.Ctl A HP
  263. ---------------- <cut> ---------------------------
  264.  
  265. If you are using a rexx script use example below.
  266.  
  267. /* Adept mail.cmd via REXX */
  268.  
  269. /* ================ ARP =========================  */
  270.  
  271.   parse arg line inbound
  272.   'c:\adept\tools\arp2\arp200.exe 'line inbound
  273.  
  274. /* =============Yatic + Yabom ===================  */
  275. 'CD \ADEPT'
  276. 'YATICP.EXE'
  277. 'cd \adept\tools\yabom'
  278. 'YABOMP.EXE MATRIX'
  279. 'cd \adept'
  280.  
  281.  
  282. 'GateKpr.Exe GateKpr.Ctl A HP'
  283.  
  284. exit
  285. /*   End.  */
  286.  
  287. Advanced Setup using Koen's mail.cmd:
  288.  
  289. /*****************************************************************************/
  290. /*    Mail.Cmd v1.1 with recycle options by Koen Koster alias CliP on IRC    */
  291. /*****************************************************************************/
  292. /*    This Mail.Cmd will recycle multiple gatekeeper tasks so that only 1    */
  293. /*    GateKeeper task is started which will handle all GK requests :-)       */
  294. /*****************************************************************************/
  295.  
  296.  
  297. /******************* < Begin Sysop Configuration Section > *******************/
  298.  
  299. AdeptDirectory = 'c:\adept'                                  /* change drive */
  300. BusyFlag       = 'c:\adept\gatekpr.busy'                     /* change drive */
  301. RunningFlag    = 'c:\adept\gatekpr.running'                  /* change drive */
  302.  
  303. /******************** < End Sysop Configuration Section > ********************/
  304.  
  305.   call RxFuncAdd 'SysLoadFuncs', 'RexxUtil', 'SysloadFuncs'
  306.   call SysLoadFuncs
  307.   curDir = Directory(AdeptDirectory)
  308.   call RxFuncAdd 'SysFileTree','RexxUtil','SysFileTree'
  309.   rc = SysFileTree(RunningFlag,"stem",'F')
  310.  
  311. /* ================ ARP =========================  */
  312.   parse arg line inbound
  313.   call 'drive:\anypathyouwant\arp.exe' line inbound
  314.  
  315. NOT tested on my system !!!
  316.  
  317. 3. Step
  318.  
  319. Now you should edit the header and footer file as you want
  320. Do not use more than 78 chars per line!
  321.  
  322. That's all you have to do!
  323.  
  324. VI - How to run Adept Request Prozessor
  325. ---------------------------------------
  326.  
  327.  
  328. See chapter V above for examples, how to run ARP in your adept configs.
  329.  
  330.  
  331.  
  332. VII - Troubleshooting
  333. ---------------------
  334.  
  335. I have tested ARP (Version I & II) for a long time without getting into any trouble.
  336.  
  337. Arp has its own error handling. If any error occures a file called 
  338. arp200.err will be created. Please send back this file !!!
  339.  
  340. Up now Adept doesn't update downloadcounters, so it is a bit boring
  341. to add the download counter [000] to all frequested files.
  342. As soon as this function will be used I will add the counters.
  343. Also the freefile tag seems to be useless.
  344.  
  345. Another strange bug of AdeptXBBS:
  346. Adept sends 'Badfreq.TXT' as often as it couldn't find a frequested file.
  347. This bug will be the reason, when ARP's response mail is send more than once!
  348.  
  349.  
  350. What is ARP doing?
  351. On a filerequest your inbound directory will contain a file called *.REQ,
  352. which is a plain ascii file. 
  353. I add a line to this file like 'Your_frequest_at_VGA-PLANETS-BOX'
  354. Adept will interpret this line as a filename, which doesn't exist.
  355. BADFREQ.TXT is send automatically to the frequester. Editing badfreq.txt
  356. is all I have to do, but ... JUST IN TIME!
  357.  
  358. If your .OK files are 5-liners, your filebase holds about 10 files
  359. there will be not enough time to edit all files while adept is working
  360. on the filerequest!
  361. If you have 5-liners or a filebase containing 10 files, you do not need
  362. my program! Send an allfiles list to everyone frequesting files at your
  363. BBS!
  364.  
  365.  
  366.  
  367. VIII - Registration:
  368. --------------------
  369.  
  370. You may registrate your copy of ARP. 
  371.  
  372. Simply send a postcard to
  373.  
  374.           Klaus Ader
  375.                   Steeler Str 286
  376.                   45138 Essen
  377.                     Germany
  378.  
  379.  
  380. IX - How to contact the author
  381. ------------------------------
  382.  
  383. You may contact me via:
  384.  
  385. Internet   : Email to klaus.ader@rz.ruhr-uni-bochum.de
  386.  
  387. Fidonet    : 2:2448/391.0@fidonet | 55:62/0.0@adeptnet
  388. BBS        :       VGA - PLANETS - BOX
  389.  
  390.          0049 201 - 898524  │ 0049 201-898598
  391.               V34 + ISDN    │      ISDN
  392.  
  393.  
  394. ***********************************************************
  395.  
  396. see ya
  397.       BK